// 2015年版权所有etcd作者
// 
// 根据Apache许可证2.0版（以下简称“许可证”）获得许可；
// 除非遵守许可证，否则不得使用此文件。
// 您可以通过
// 
// www.apache.org/licenses/LICENSE-2.0 
// 
// 除非适用法律要求或书面同意，否则根据许可证分发的软件
// 按“原样”分发，
// 无任何明示或暗示的保证或条件。
// 请参阅许可证，了解管理许可的特定语言和
// 许可证下的限制。

// 包testutil提供测试实用程序函数。
package testutil

import (
	"net/url"
	"os"
	"runtime"
	"testing"
	"time"
)

// WaitSchedule短暂休眠以调用go调度程序。
// 待办事项：当我们能够了解目标围棋程序的日程安排或状态时，改进这一点。
func WaitSchedule() {
	time.Sleep(10 * time.Millisecond)
}

func MustNewURLs(t *testing.T, urls []string) []url.URL {
	if urls == nil {
		return nil
	}
	var us []url.URL
	for _, url := range urls {
		u := MustNewURL(t, url)
		us = append(us, *u)
	}
	return us
}

func MustNewURL(t *testing.T, s string) *url.URL {
	u, err := url.Parse(s)
	if err != nil {
		t.Fatalf("parse %v error: %v", s, err)
	}
	return u
}

// FatalStack有助于终止测试并打印出所有正在运行的goroutine的堆栈。
func FatalStack(t *testing.T, s string) {
	stackTrace := make([]byte, 1024*1024)
	n := runtime.Stack(stackTrace, true)
	t.Errorf("---> Test failed: %s", s)
	t.Error(string(stackTrace[:n]))
	t.Fatal(s)
}

// ConditionFunc在满足条件时返回true。
type ConditionFunc func() (bool, error)

// Poll在轮询间隔内重复调用条件函数，直到返回true、返回错误
// 或达到超时。如果条件函数在超时之前返回true或错误，Poll 
// 立即返回true值或错误。如果超过超时，轮询将返回false。
func Poll(interval time.Duration, timeout time.Duration, condition ConditionFunc) (bool, error) {
	timeoutCh := time.After(timeout)
	ticker := time.NewTicker(interval)
	defer ticker.Stop()

	for {
		select {
		case <-timeoutCh:
			return false, nil
		case <-ticker.C:
			success, err := condition()
			if err != nil {
				return false, err
			}
			if success {
				return true, nil
			}
		}
	}
}

func SkipTestIfShortMode(t TB, reason string) {
	if t != nil {
		t.Helper()
		if testing.Short() {
			t.Skip(reason)
		}
	}
}

// 如果检测到短路测试模式，ExitInShortMode将关闭当前进程（0）。
// 
// 用于测试主节点，测试上下文（testing.TB）不可用。
// 
// 除“go TEST--SHORT flag”外，还需要自定义环境变量（GOLANG_TEST_SHORT）。
func ExitInShortMode(reason string) {
	if os.Getenv("GOLANG_TEST_SHORT") == "true" {
		os.Exit(0)
	}
}
